package top.lixunda.ecommerce.server.good.api.controller;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;
import top.lixunda.commerce.common.core.entity.MessageObject;
import top.lixunda.ecommerce.server.good.api.entity.dto.QuestionChangeDTO;
import top.lixunda.ecommerce.server.good.api.entity.dto.QuestionInsertDTO;
import top.lixunda.ecommerce.server.good.api.entity.vo.QuestionVO;
import top.lixunda.common.validate.XumValid;

import java.util.List;

/**
 * <p>
 * Feign客户端，接口调用
 * FQA 常问问题数据表，目前由商家进行设置
 * </p>
 *
 * @author Xumda
 * @version time:2020/1/7 15:54
 */
@SuppressWarnings("unused")
@Api("FQA操作")
@RequestMapping("/frequently-question")
public interface IFrequentlyQuestionController {

    /**
     * 批量插入FQA
     *
     * @param questionInsertDtoList FQA数据
     * @return 插入成功的数量
     */
    @ApiOperation("批量插入FQA")
    @PostMapping("saveFqas")
    MessageObject<Integer> saveFqas(
            @RequestBody @XumValid List<QuestionInsertDTO> questionInsertDtoList);

    /**
     * 根据商品id查询所有FQA数据
     *
     * @param id 商品id
     * @return 该商品可以展示的FQA数据，不一定是商品特有的，也可能是店铺共有的
     */
    @ApiOperation("根据商品id查询所有FQA数据")
    @GetMapping("queryAllFqaByGoodId")
    MessageObject<List<QuestionVO>> queryAllFqaByGoodId(@RequestParam("id") Integer id);

    /**
     * 根据商品id列表查询所有FQA数据
     *
     * @param ids 商品id列表
     * @return 该商品可以展示的FQA数据，不一定是商品特有的，也可能是店铺共有的
     */
    @ApiOperation("根据商品id列表查询所有FQA数据")
    @PostMapping("queryAllFqaByGoodIds")
    MessageObject<List<QuestionVO>> queryAllFqaByGoodIds(@RequestBody List<Integer> ids);

    /**
     * 根据店铺id查询所有FQA数据
     *
     * @param id 店铺id
     * @return 该店铺中的所有FQA数据
     */
    @ApiOperation("根据店铺id查询所有FQA数据")
    @GetMapping("queryAllFqaByStoreId")
    MessageObject<List<QuestionVO>> queryAllFqaByStoreId(@RequestParam("id") Integer id);

    /**
     * 根据店铺id列表查询所有FQA数据
     *
     * @param ids 店铺id列表
     * @return 该店铺中的所有FQA数据
     */
    @ApiOperation("根据店铺id列表查询所有FQA数据")
    @PostMapping("queryAllFqaByStoreIds")
    MessageObject<List<QuestionVO>> queryAllFqaByStoreIds(@RequestBody List<Integer> ids);

    /**
     * 根据id查询单条FQA数据
     *
     * @param id id
     * @return FQA数据
     */
    @ApiOperation("根据id查询所有FQA数据")
    @GetMapping("queryFqaById")
    MessageObject<QuestionVO> queryFqaById(@RequestParam("id") Integer id);

    /**
     * 根据id列表查询所有FQA数据
     *
     * @param ids id列表
     * @return 该id列表包含的所有FQA数据
     */
    @ApiOperation("根据id列表查询所有FQA数据")
    @PostMapping("queryFqaByIds")
    MessageObject<List<QuestionVO>> queryFqaByIds(@RequestBody List<Integer> ids);

    /**
     * 根据FQA的id更新FQA数据
     *
     * @param questionChangeDTO 更新FQA的DTO
     * @return 更改之后的DTO数据
     */
    @ApiOperation("根据FQA的id更新FQA数据")
    @PostMapping("changeQuestionById")
    MessageObject<QuestionVO> changeQuestionById(
            @RequestBody @XumValid QuestionChangeDTO questionChangeDTO);

    /**
     * 根据id删除FQA数据
     *
     * @param ids FQA的唯一id列表
     * @return 返回删除成功的数量
     */
    @ApiOperation("根据id删除FQA数据")
    @PostMapping("removeQuestionByIds")
    MessageObject<Integer> removeQuestionByIds(@RequestBody List<Integer> ids);

}
